home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / U-V / Userlog Utils.cpt / ListUsers_UL2TXT_TXT2UL Notes < prev    next >
Text File  |  1988-11-07  |  6KB  |  143 lines
  1. ListUsers 3.0, UL2TXT, & TXT2UL Notes
  2.  
  3. These utilities evolved from my earlier ListUsers utility, which simply
  4. translated the Userlog into sorted text form.  ListUsers 3.0 performs the same
  5. function, but also provides the capability to sort the actual Userlog as well
  6. as to clear any or all of the System<n>.MSG flags.
  7.  
  8. The other utilities perform inverse functions, UL2TXT converting the Userlog
  9. into a tab-delineated text format, and TXT2UL converting a suitably formatted
  10. file back into Userlog form.  The primary difference between UL2TXT and
  11. ListUsers is that the former program outputs every piece of information within
  12. the file, including which messages sections are selected for "Read All", which
  13. System.Msg files have been read and terminal options.  The output is also much
  14. harder to read from a human perspective.  It was written so that I could use
  15. global changes within a text editor, i.e. 'Change all users with a time limit
  16. of 60 and a privilege of 80, to a time limit of 75 and a privilege level of 80'
  17. or 'Add msg base 11 to all users'.
  18.  
  19. Both ListUsers and UL2TXT output with a file type of QED1, which is that used
  20. by QUED and QUED/M.  QUED/M is unquestionably the best text editor available,
  21. and much of the power comes from macro capabilities.  For example, I recently
  22. changed my entire menu structure so that all file DL commands with a privilege
  23. level of '>80' were changed into 3 commands at levels =80, =100, and >=120. The
  24. rest of the command, including the file section path was unchanged. The
  25. important thing about this is that I did it as a global change on multiple
  26. sections and I am certain that none were missed, in addition to avoiding a lot
  27. of tedious labor. (This operation was performed by using ListMenus to get a
  28. single text file listing all the menus, editting it, and rebuilding the menus
  29. from the text file, also using ListMenus.)  If you run a RRHost BBS, QUED/M is
  30. worth the money!
  31.  
  32. Details:
  33.  
  34. ListMenus 3.0
  35.  
  36. If the Userlog is not in the same folder as ListUsers, then a very brief error
  37. message will be displayed and the program will terminate.  Otherwise the
  38. following dialog will occur. Computer prompts are shown in quotes:
  39.  
  40. ' Possible Sort Options: '
  41.  
  42. ' NAME or ACCESS or DLS or ULS or LEVEL or DATE'
  43.  
  44. 'Enter option (<CR> = No Sort) : ' <response>
  45.  
  46. This answer just tells the program how to sort the output. Case is unimportant,
  47. although the entire would should be entered.
  48.  
  49.  
  50. ' Possible Output Options: '
  51.  
  52. ' BRIEF, NONE or <CR>'
  53.  
  54. 'Enter option (<CR> = Full output) : '<response>
  55.  
  56. Once again case is insignificant, but these options can be abbreviated, i.e. a
  57. "b" is as good as "BRIEF".  Brief output omits the password, so that output
  58. could be distributed without compromising security.  NONE will prevent any text
  59. output.  The default if full output including passwords.  The output file will
  60. always be "USERLOG.Lst"
  61.  
  62. ' Save modified UserLog?: '
  63.  
  64. 'Y or N  (Defaults to Yes) '<response>
  65.  
  66. Anything other than a 'No' response wil cause ListUsers to rewrite the Userlog
  67. with a sorted copy.  If the answer is no, the next question will be skipped
  68. since it doesn't make sense to clear the flags unless one is planning to save
  69. the modified copy.
  70.  
  71. 'Clear System<N>.Msg Read flag?'
  72.  
  73. 'Enter "1" and/or "2" and/or "3" to clear that flag: '<response>
  74.  
  75. If a "2" is entered, RRHost will mark SYSTEM2.MSG as unread by all users. The
  76. numbers "1" and "3" are handled the same.  Any subset may be entered, i.e. "1",
  77. "31", "23" and "12" are all legal.
  78.  
  79. After all the questions are answered, the Userlog is processed, and USERLOG.LST
  80. is (conditionally) produced.
  81.  
  82.  
  83.  
  84. UL2TXT
  85.  
  86. The program must be in the same folder as the Userlog.  When opened the program
  87. creates a file called UserLog.TXT which can be viewed with any text editor. The
  88. output consists of one line per user.  Each line contains:
  89.     Privilege level
  90.     Time Limit
  91.     Number of calls
  92.     Number of msgs
  93.     Number of Private messages
  94.     Number of DLs
  95.     Number of ULs
  96.     Messages Sections fo Read ALL (see below)
  97.     Flags  (also see below)
  98.     Date & Time of last call.
  99.     First Name
  100.     Last Name
  101.     Password
  102.     Location
  103.  
  104.  
  105. The message sections which are visible with the Read All command are indicated
  106. with an asterisk in a 20 column record, e.g  "***..**.***........."  indicates
  107. that this user can read bases 1,2,3,6,7,9,10, and 11, and can not read 4,5, or
  108. 8.  The first column is always set and can be used as a placeholder for a text
  109. editor.  The QUED/M command, if used in a macro,
  110.     Change "\(\*.......\)." to "*\1*" " would set all users to read base 8
  111. without changing the other settings.
  112.  
  113. The flags field is shown in a similar manner.  The string, "LXH.2.&", shows
  114. that this user requires a Linefeed after each return, doesn't want any 'screen
  115. feeds', wants 'H' menus, and has read SYSTEM2.MSG, but not SYSTEM1.MSG or
  116. SYSTEM2.MSG.  The '&' is just there for text editor change commands. The 'X'
  117. field would be a "." if a FormFeed is to be used for new screens and would be
  118. "C" if 24 carriage returns are to be used.
  119.  
  120. The other fields are fairly obvious.
  121.  
  122.  
  123. TXT2UL
  124.  
  125. The last program simply takes a 'USERLOG.TXT' file, in the same folder as the
  126. program, and converts it to a Userlog. The flags and msg base fields are
  127. interpreted as noted above.  Very little error checking is done, so be careful. 
  128. For example, trailing blanks are not stripped, so one could easily change a
  129. user name and not see it.  Every field must be separated from the others by a
  130. Tab character.  Failure to do so could cause real problems.
  131.  
  132.  
  133. Rights and such...
  134.  
  135. I retain all rights to these programs, but they may be freely used and freely
  136. distributed, as long as this file is included in the distribution package. (I
  137. prefer not to answer questions from people with executables but no docs!)  I
  138. encourage users to check out my shareware products, FSP, AnalyzeCL, ListMenus,
  139. and TSX, available on the FreeSoft RT on GEnie.
  140.  
  141. PS: If anyone wishes to put together a Hypercard stack the reads UL2TXT output
  142. and produces a Userlog stack, they have my encouragement.  I'll do one
  143. eventually if no one beats me to it.